Inside Macintosh: QuickDraw GX Graphics /

Chapter 4 - Geometric Operations / Geometric Operations Reference

Functions / Performing Geometric Arithmetic With Shapes

GXInvertShape

You can use the GXInvertShape function to invert a shape.

void GXInvertShape(gxShape target);

target

A reference to the shape to invert.

DESCRIPTION

The GXInvertShape function inverts the target shape and stores the resulting shape in the target shape. Typically, this function changes the shape fill of the target shape. It also converts empty shapes to full shapes and full shapes to empty shapes.

If the target shape has one of the framed shape fills (open-frame or closed-frame), this function posts the error shape_cannot_be_inverted.

For empty shapes, this function coverts the shape to a full shape; for full shapes, it comverts to empty shapes.

If you provide a target or operand shape that is not one of the geometric shape types, this function performs the actions described in the following table:

Shape type	Action taken
bitmap	Posts the error shape_cannot_be_inverted
picture	Posts the error shape_cannot_be_inverted
text	Posts the error shape_cannot_be_inverted
glyph	Posts the error shape_cannot_be_inverted
layout	Posts the error shape_cannot_be_inverted

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
shape_cannot_be_inverted	(debugging version)
shape_access_not_allowed	(debugging version)

SEE ALSO

For an example using this function, see "Performing Geometric Arithmetic With Shapes" beginning on page 4-60.

For a discussion of geometric arithmetic, see "Geometric Arithmetic" beginning on page 4-21.

For a discussion of shape fills, see Chapter 2, "Geometric Shapes," in this book.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help